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Abstract 


This paper describes the principal features of the <APRSdec> program.. The program fully decodes 
raw APRS packets, producing reports in plain English. It has proved to be an extremely useful APRS 
diagnostic and learning tool. <APRSdec> is written in Perl, and runs under native DOS, Windows, 
Unix and Linux. It is available from http ://ww.tapr.org/-g3nm 


Introduction 


<APRSdec> started life towards the end of 1999, when I was working on the APRS Protocol Specification. I 
needed a simple tool to decode the many different types of APRS packet seen on air, to help me verify that I 
understood all the formats. Later, in the spring and early summer of 2000, the program unexpectedly came into 
its own as a diagnostic tool, when floods of badly corrupted packets appeared on the APRS network (arising 
from a combination of broken APRS client software and broken IGate server software). <APRSdec> was 
invaluable in reporting the errors and providing clues towards identifying the culprits. 


<APRSdec> is a particularly useful tool for: 
APRS software development and testing. 
PIC development and testing. 
4 Network fault-finding and diagnostics. 
) Learning about the APRS protocol. 


<APRSdec> Features 


Runs under native DOS, Windows 95/98 and LinuxAJnix. (It will almost certainly run under Windows 
NT and Windows 2000 as well, but this has not been tested). 

Accepts raw input in TNC/IGate terminal output format. 

Accepts raw input in UI-View two-line log format, and decodes the 15-digit UI-View timestamp. 
Performs rigorous format checking, with detailed error reporting. 

Understands position ambiguity, reporting the bounding box in which the station is located. 

Compares lat/long position against a prefix/country database - if the station’s position appears to be 
outside the country, <APRSdec> reports a possible anomaly. 

Reports data values in imperial, nautical and metric units. 

Fully decodes Mic-E and compressed position formats. 

Recognizes data from Kenwood TH-D7 and DM-700 radios, and changes the incorrect DM-700 APRS 
Data Type Identifier to “Current Mic-E Data’. 

Provides detailed weather station reports, including the calculation of windchill and dew point. 
Decodes storm data. 

Decodes bearing and range data. 

Decodes DX Cluster reports, showing the data as it will appear on TH-1~7 and DM-700 screens. 


Some Examples of <APRSdec> Output 
A simple lat/long report: 


Record #170 

KE4SZT>APRS, VWANHV- 9, W DE~, W DE/ 2: ~270700z3408. 76N 07924~6QW John in Marion, SC 793- 
APRS Data Type= Posit w tine. Wth APRS 

Day= 27 Tine= 07 hours 00 nins UTC 

Lat= 34 deg 08.76 mn N_ Long= 79 deg 24.60 nin W 


Icon= House QTH VHF Overlay= (none) 
-“WWwW- meee eee ee ee eee eee eee eee ee eee eee eee ee ee 


A Mic-E report. CAPRSdew recognizes this comes from a Kenwood TM-D700 radio and automatically 
corrects the APRS Data Type to “Current Mic-E data”: 


Record #8051 

KC7EQL>VE7VAN- 3~~>W DE3- 1>T8PVPW' 37]1 1 e-/]~SS~Mark at Hone awaits Sunsat 
APRS Data Type= Current Mc-E data 

Radi o= Kenwood TM D700 

Message Type= /M2/In Service 

Lat= 48 deg 07.07 nin N Long= 123 deg 27.65 nin W 

Icon= House QIH VHF Over! ay= (none) 

Course= 173 deg Speed= 4 knots (4.6 nph 7.4 kph 2.1 ms) 

Altitude= 397 feet (121 neters) 


Record #1763 


NOI DH>APRK11, AE9A- 10~~, W DE3- 2: ; AD 6 , 111826z\ YH! 3vA! Sk~! R=05280/ 437. 051/ 13Khz/ APRSt k 
APRS Data Type= Obj ect 
Obj ect Nane= ' A016 ' Qj ect Status= Killed 


Day= 11 Tine= 18 hours 26 nins UTC 

Lat= 81 deg 14.20 nin N’_ Long= 14 deg 04.30 nin W 

CPS Fix= Ad (last) NMEA Source= Other Conpression Ori gi n= Conpressed 
Course= 296 deg Speed= 1018 knots (1171.5 nph 1885.3 kph 523.7 nis) 


Icon= Satellite/PAC Overlay= (none) 
-e--Ww- see eee eee eee ee 


A Long Way from Home 


This UI-View report (complete with the decoded UI-View timestamp) shows APRS Working Group Chairman 
John Ackermann, N8UR, jogging towards G3NRW’s home at over 72mph -- he was on a train at the time! 
cAPRSdec> recognizes that John is outside the contiguous 48 states, so it questions the reported location: 


Record #622 
NBUR- 7" ~>RELAY>W DE>W DE>W DE2- 2>Ul UWXX ~(Ul):' vSf"> [/>"58) 
U-Vi ew Ti nestanp= 27 May 2000 12 hrs 58 nins 32 sets (PC cl ockti ne) 
APRS Data Type= Current Mc-E data 
Radi o= Kenwood TH- D7 
Message Type= /M2/In Service 
Lat= 51 deg 56. 88 nin N Long= 0 deg 29. 74 mn W 
;“SQUESTION Is this lat/long position reasonabl e? 
It seens a long way fromhone for this callsign. 
Icon= Jogger Overlay= (none) 
Course= 1 deg Speed= 63 knots (72.5 nph 116.7 kph 32.4 nis) 
Altitude= 407 feet (124 neters) 
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The next report is an example of how data was corrupted 


somewhere in the APRS network - the leading longitude digit 4 
was somehow changed from | to 0, making N7FSP-7 appear in 
the Atlantic Ocean, 600 miles off the southwest coast of Ireland: From 22.23 87W,47.32.36N | 
To: 10.14.69W.51.48.53N 
Record #646 . Se 


N7FSP- 7>APK101, N7OEP- | O~~, W DE3- 2: @11181624732. 21 N Q2222. 65W : 5? degees 
O00/ COO’ M c- E/ M)/ OF f= duty> pear bo Hide” 
APRS Data Type= Posit w tine. Wth APRS 
Day= 11 Tine= 18 hours 16 nins UTC 
Lat= 47 deg 32.21 nin N Long= 22 deg 22.65 nin W 
% QUESTION: Is this lat/long position reasonabl e? 
It seens a long way fromhone for this callsign. 
Icon= House QIH VHF Over! ay= (none) 
Course= (Indeterninate) deg Speed= 000 knots (0.0 nph 
0.0 kph 0.0 nis) 


Position Ambiguity 

Position ambiguity allows a station to specify its approximate rather than absolute position. One way to do this 
is to replace coordinate digits with spaces. For example, G3NRW’s home to the nearest minute of latitude and 
longitude could be specified as 5157.,-N and 00029.,,W (where , represents a space). This means that the 
latitude may be anywhere between 5 1° 57.0CJ and 5 1° 57.99’ N and the longitude may be anywhere between 
000’ 29.00’ and 000’ 29.99’ W. In other words, G3NRW is located somewhere inside the bounding box shown 
below: -- 


© UL-View V2.24 (HOME: 4 MILES] ; — : = & 
File Tetminal. Stations. Messages Map Logs. Lists Action Options Setup Hep 
Soo A 


| [5457.99N 00029.99W kL 
i 


cong Ns NGHTL nies La 


area (3.2 km) 


Record # 

C3NRW >APRS: !5157. N 00029. W 

APRS Data Type= Posit wo tine. No APRS 

Anbi guous position. Opposite corners of bounding box: 
NW Corner: Lat= 51 deg 57.99 nin N Long= 0 deg 29.99 mn W 
SE Corner: Lat= 51 deg 57.00 nin N Long= 0 deg 29.00 mn W 


_Icon= House QTH VHF Overlay= (none) ' 
ae ee Pe m 
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<APRSdec> similarly reports a bounding box for a Maidenhead grid locator: 
Record #459 
CTI DBH- | >! D: [1 Mb8! S] 
APRS Data Type= Maidenhead Grid Square 
Maidenhead | ocator bounding box: 
NW Corner: Lat= 38 deg 47.50 min N Long= 9 deg 20 mn W 
SE Corner: Lat= 38 deg 45.00 nin N Long= 9 deg 15 mn W 
*"' NOTE: This Maidenhead fornat wth square brackets is obsol ete. 


Record #S084 


APRS Data Type= Posit w tine. Wth APRS 
Day= 11 Tine= 19 hours 55 mins UTC 
Lat= 44 deg 47.06 nin N Long= 93 deg 29.48 nmin W 
Icon= VK station Overl ay= (none) 
Whnd Direction= 125 deg Speed= 008 knots (9.2 nph 14.8 kph 4.1 nis) 
Gust Speed= 9 nph (14.5 kph 4.0 nis 7.8 knots) 
Tenp= 79 degF (26.1 degC) Whdchill = 76.5 degF (24.7 degC) 
Rain: Last hour= 0 in (0.0 nn) Last 24 hrs= 0.03 in (0.8 nm) 
Since mdni ght= (Indeterminate) 
Hum dity= 41 percent Dew Poi nt= 53.2 degF (11.8 degC) 


eee ee eee ee eee 


Record #3852 
NAAV- 3>RESORC, AB4KN- 2: “, WDE3-2:DX de NMV-3 >FQ29GL509 FO20@L503 SATS 
DX Cluster I nfornati on: 
TH D7 Screen 1 TH D7 Screen 2 T D700 

prcrtcccssccsss Se : ern + 

1 Dx: FQ2QO@L503 1 1 Dx: FO20@L503 ; 1 |: FQ20@1503 FO29GL509 SATSI 

1 Fag9@i509 | i | | | 

| SATS I 1 | | | 

Lar Ree Reese qe pS Se eee + | | 

eat atatatel + 


Input Files 


cAPRSdec> understands input data in regular TNC/Igate terminal format: e.g. 
WOZCU>APR846, VWA4WHD- 3-++~, W DE/ V: =2559. N/ 08010. WPHC6560/ Carl's Castle! 
and in two-line UI-View log format: e.g. 


36673. 5168518519~MLDTA>MB7UPG>G YFF~*>T~CE3-| >APRS [UI]: 
=5143. 43N 00035. 88EUM DTA Bob on Danbury Hill. Enail address: nidta@yahoo. com 


To obtain raw data from an [Gate, you can telnet to it; e.g. telnet www.aprs.net. However, many APRS report 
lines are much longer than the 80,character line limit of most telnet clients. These lines will be split, so that 
some reports may occupy 2 (or even 3) separate lines. It is possible to join them up again using a text editor, 
but that is a long, tedious process! 


Much better is to use a telnet client that can read long lines without wrapping or truncating. By far the best I 
haveseenis ~era~erm~~~, frOmhttp://hp.vector.co. jp/authors/VA002416/teraterm.html. 


157 


